home *** CD-ROM | disk | FTP | other *** search
/ Euroscene 1 / Euroscene 1.iso / bdgtti_2.2 / readme < prev    next >
Text File  |  1994-04-25  |  13KB  |  330 lines
  1. --- big-dummys-guide-texi/$Id: README,v 2.2 1994/02/06 13:54:24 joke Rel $
  2.  
  3.  
  4. SPREAD THE WORD:
  5.  
  6.     "The Big Dummy's Guide to the Internet is now available,
  7.      in a variety of easily convertible formats *and*
  8.      at your local laser printer."
  9.  
  10.  
  11.             -=- * -=-
  12.  
  13.     * WHAT IS BIG DUMMY'S GUIDE?
  14.  
  15.    This is still the first Texinfo edition of a book entitled "Big
  16. Dummy's Guide to the Internet" (aka "bdgtti.texi") written by
  17. Adam Gaffin for a joint project of Apple Computer, Inc. and
  18. The Electronic Frontier Foundation (EFF).
  19.  
  20.             -=- * -=-
  21.  
  22.     * WHERE DO I GET THE HYPERCARD STACK?
  23.  
  24.    Steve Cisler courtesy of the Apple Library, used a Macintosh
  25. computer and converted Adams writing into a so-called HyperCard
  26. stack; this stack, readable by the HyperCard software that comes
  27. bundled with every Mac, is available via anonymous FTP from the EFF's
  28. server "ftp.eff.org" as file "big-dummys-guide.sea.hqx" see under
  29. "pub/Net_info/Big_Dummy". More versions, e.g. AmigaGuide and
  30. GeoWorks Write are also available, the latter by Adam himself (cf.
  31. VERSIONS).
  32.  
  33.             -=- * -=-
  34.  
  35.     * AND THE ORIGINAL ASCII?  WHAT'S THE DIFFERENCE?
  36.  
  37.    Also available in the same directory is Adam's original ASCII
  38. version "big-dummys-guide.txt" (currently at version 2.2) that served as the
  39. starting point for this Texinfo based release.
  40.  
  41. Besides several "bug fixes," witty quotes, corrections, including
  42. some complete rewrites (cf Chapter 8) and the new layout, some more
  43. value has been added; notably, two personal articles from EFFector
  44. Online, the EFF's bi-weekly news magazine (available in comp.org.eff.news
  45. on USENET), now serving as superb afterwords, and some other
  46. contribution of Netizens I found quite worthwhile reading over
  47. the past years:
  48.  
  49.             -=- * -=-
  50.  
  51.     * NOW, WHAT'S IN THERE?
  52.  
  53.    * "A Slice of Life in my Virtual Community" by Howard Rheingold
  54. describes the social life on the Internet from the WELL's point
  55. of view.
  56.  
  57.    * "A Statement of Principle" by SF author Bruce Sterling
  58. discusses some moral and legal issues you will definitely get to
  59. know when becoming a "cybernaut" on Internet.
  60.  
  61.    * "Subject: TIME Article on Internet" by Philip Elmer-Dewitt
  62. shows , that even the non-virtual world (aka "reality") finally got
  63. interested in cyberspace, and the cybernauts on Internet.
  64.  
  65.    * "Subject: A Perspective on NREN" by Grag Chartrand *parodies*
  66. the NSF's proposed US National Education and Research Network.
  67.  
  68. Moreover a bibliography has been stuffed into this edition:
  69.  
  70.    * A comprehensive list of Paperware related to the Internet
  71. (This is an updated version of the bibliography section that
  72. comes with the first edition of "Zen and the Art of the
  73. Internet" by Brendan Kehoe, plus part of the reference section of
  74. Henry Edward Hardy's Master's Thesis "The History of the Net"
  75. written at the School of Communications, Grand Valley State
  76. University, Allendale, MI 49401. Version 7.2 was posted to
  77. comp.org.eff.talk on August 28, 1993.)
  78.  
  79.             -=- * -=-
  80.  
  81. This guide is 242 European A4 size pages in length, (i.e. 292
  82. US-letter size pages) and is divided into the following sections:
  83.  
  84. * A 5 part Introduction
  85.  - G'day by the Texinfo editor
  86.  - Welcome by Shari Steele, EFF
  87.  - Forward by Mitchell Kapor, EFF
  88.  - Addendum to Forward by Mitchell Kapor and Jerry Berman, EFF
  89.  - Preface by Adam Gaffin, Middlesex News, Boston, MA, USA.
  90.  
  91. * A 13 part Walk-trough-the-Internet
  92.  Chapter 1   -- Setting up, Getting connected, Jacking in...
  93.  Chapter 2   -- Electronic Mail
  94.  Chapter 3   -- Usenet: the Global Watering Hole
  95.  Chapter 4   -- Usenet: from Flame Wars to Killfiles
  96.  Chapter 5   -- Mailing Lists and Bitnet
  97.  Chapter 6   -- Telnet (Mining the Net, part I)
  98.  Chapter 7   -- FTP (Mining the Net, part II)
  99.  Chapter 8   -- Gophers, WAISs, and the World-Wide Web
  100.  Chapter 9   -- Advanced E-mail
  101.  Chapter 10  -- News of the World
  102.  Chapter 11  -- IRC, MUDs, and other things...
  103.  Chapter 12  -- Education on the Net
  104.  Chapter 13  -- Business on the Net
  105.  
  106. * A 5 part Afterword
  107.  - "Conclusion: the End?" by Adam Gaffin
  108.  - "A Slice of Life in my Virtual Community" by Howard Rheingold
  109.  - "A Statement of Principle" by Bruce Sterling
  110.  - "Subject: TIME Article on Internet" by Philip Elmer-Dewitt
  111.  - "Subject: A Perspective on NREN" by Greg Chartrand
  112.  
  113. * A Bibliography
  114.  - Paperware on the Internet: A comprehensive list of over
  115.    200 (sic!) literary references of books, papers, magazines,
  116.    newspaper bits, and electronically published texts, all of them
  117.    related to the Internet and similar topics.
  118.  
  119. * 5 Appendices
  120.  - Appendix on Internet Jargon
  121.  - Appendix by Ms. Emily Postnews
  122.  - Appendix on The Electronic Frontier Foundation
  123.  - Appendix on Internet Country Codes (ISO 3166)
  124.  - Appendix on Smileys: ``The Unofficial Smiley Dictionary''
  125.  
  126. * 4 Indices
  127.  - E-mail addresses mentioned
  128.  - Internet Sites mentioned
  129.  - Commands, Suffixes, and Tools mentioned
  130.  - General Index
  131.  
  132.  
  133.             -=- * -=-
  134.  
  135.     * WHY DO YOU WANT THIS?
  136.  
  137.    Why do you want this? Well, for one thing, it's better than Bloomfield's
  138. "99 more things to do in zero gravity", and then it's free. So what
  139. else do you expect? Ok, for an encore: it definitely saves you some time
  140. and trouble: traditionally users learned by word of mouth, stumbling
  141. upon things, being trapped by dozens of pitfalls, and laughed at by
  142. systems wizards. These times are OVER!
  143.  
  144. This guide should serve as a first straw to clutch at when you're stranded
  145. in this mindboggling universe called Internet; and are curious about what
  146. else can be done. It also presents the fundamental topics on a "rookie"
  147. level that are all too often assumed and considered trivial by many more
  148. experienced network users/admins/gurus.
  149.  
  150.             -=- * -=-
  151.  
  152.     * WHERE DO YOU GET IT?
  153.  
  154.    It should be available from the EFF's FTP server "ftp.eff.org" in the
  155. "pub/Net_info/Big_Dummy" directory.
  156.  
  157. Just check out the European edition on "ftp.germany.eu.net" in
  158. "pub/books/big-dummys-guide". See below for instructions on "How to configure
  159. DUMMY's". AND read the SERVERS file that comes with the Texinfo distribution
  160. for more servers than you probably need...
  161.  
  162.             -=- * -=-
  163.  
  164.     * DISTRIBUTION DIRECTORY:
  165.  
  166.                         |-README                 // FAQ file
  167.                         |-README.VMS             // help for VMS folks
  168. |-big-dummys-guide-texi-|-bdgtti-2.2.ps.gz       // PostScript
  169.                         |-bdgtti-2.2.dvi.gz      // TeX DVI file
  170.                         |-bdgtti-2.2-US.dvi.gz   // TeX DVI US paper
  171.                         |-bdgtti-2.2-US.ps.gz    // TeX PS US paper
  172.                         |-bdgtti-2.2.info.gz     // GNU Info file
  173.                         |-bdgtti-2.2.txt.gz      // TEXT file
  174.                         |-bdgtti-2.2.html.tar.gz // HTML (WWW) files
  175.                         |-bdgtti-2.2.amiga.lha   // AmigaGuide files
  176.                         |-bdgtti-2.2.tar.gz      // all Texinfo sources
  177.  
  178. Both sites can uncompress the files "on the fly", i.e., you do not need to
  179. have the GNU gunzip utility. Just get the files with the ".gz" extension:
  180.  
  181.    get bdgtti-2.2.ps
  182.  
  183. instead of:
  184.  
  185.    get bdgtti-2.2.ps.gz
  186.  
  187.  
  188.             -=- * -=-
  189.  
  190.     * WHAT ARE ALL THESE FILES?
  191.  
  192.    Now, how to read it. The file bdgtti-2.2.dvi is a DVI (DeVice
  193. Independent) file created by the TeX typesetting system. Filters
  194. exist to convert these DVI files into printer-specific files for
  195. a variety of printers. Also included is the file bdgtti-2.2.ps,
  196. a PostScript version. bdgtti-2.2.txt is the plain ASCII version
  197. of bdgtti-2.2.info, ie. the latter can be browsed either using
  198. EMACS in INFO mode, or any GNU info browser, e.g. "info", or
  199. "xinfo". Just type "info -f bdgtti-2.2.info" and there you go.
  200.  
  201. For the folks who want to print the PS version on a Hewlett-Packard
  202. laser printer with Postscript option, take care. You cannot print
  203. the file double-sided, which results in "0.5in upwards shifted" even pages;
  204. but printing it single-paged is ok. This is obvioulsy due to a bug in the
  205. HP-printer's firmware, and was reported by Ed Moore of HP, using a
  206. LaserJet 4Si (with PostScript option, of course).
  207.  
  208. Dawn Cooley reported troubles with a Texas Instruments microLaser Turbo.
  209. After downloading Adobe's error handler, DUMMY's printed fine.
  210.  
  211. The tar file with suffix ".html" contains DUMMY's in some 300 files in
  212. HyperText Markup Language format. They can be thrown into your
  213. system's World-Wide Web directory, and then browsed using the
  214. various WWW tools. E.g. from within xmosaic "Load Local" bdgtti-2.2_toc.html,
  215. and there you go! An alternative is to set the default home page environment
  216. variable with: "setenv WWW_HOME bdgtti-2.2_toc.html" which makes DUMMY's the
  217. HOME page (press the HOME button to get back to the top) on startup.
  218.  
  219. (Well, at least when xmosaic is installed on your system. If it's
  220. not, BUG YOUR SYSTEM ADMINISTRATOR! He obviously missed the
  221. leading edge of today's infosystems technologies.)
  222.  
  223. In the tar file bdgtti-2.2.tar.gz (a gzip'ed tar file---ask
  224. YOUR LOCAL SYSTEM ADMINISTRATOR and/or Unix guru how to extract
  225. the files from this), there are a number of files suffixed by
  226. ".texi". These are all the Texinfo sources to this guide.
  227. Note again that on the eff.org site, this file will have a .z extension,
  228. not a .gz extension, though it is the same sort of archive.  This is due
  229. to a lousy script, and should be fixed Real Soon Now.
  230.  
  231. New in the collection is bdgtti-2.2.amiga.lha, an archive containing
  232. the AmigaGuide (cf VERSIONS below) version of the book.
  233.  
  234.             -=- * -=-
  235.  
  236.     * FYI: WHAT IS TeX?
  237.  
  238.    FYI: TeX is a free typesetting system by Don Knuth of Stanford;
  239. the source of which you can FTP or buy on a tape. Texinfo is a
  240. package of macros written on top of TeX by the GNU Project for
  241. easy manual creation. See the FTP Chapter in DUMMY's on how to
  242. obtain TeX.
  243.  
  244.             -=- * -=-
  245.  
  246.     * HOW TO CREATE A DVI FILE?
  247.  
  248.    Well, first you must configure DUMMY's to produce an US letter
  249. size, or a European A4 paper size version: this can easily be done
  250. with the provided "configure" shell script (C-shell), eg.:
  251.  
  252.    example % configure --letter
  253. Or:
  254.    example % configure --a4
  255.  
  256. Note, that "example %" represents your system's input prompt, that might look
  257. different for you, eg. on MS-DOS you're used to see something like "C:\DUMMY>".
  258. You might also configure DUMMY's "by hand", e.g. for the letter size version:
  259.  
  260.    example % cp config/Makefile.us Makefile
  261.    example % cp config/bdgtti.us bdgtti.texi
  262.  
  263. And for the A4 version:
  264.  
  265.    example % cp config/Makefile.a4 Makefile
  266.    example % cp config/bdgtti.a4 bdgtti.texi
  267.  
  268. To create a DVI file of your own (e.g. to produce an A4 paper version),
  269. simply run "texi2dvi" on bdgtti.texi twice; or use the Makefile included;
  270. it does almost *everything* for you (...although "make coffee" doesn't work,
  271. yet). All there is to do is to type:
  272.  
  273.    example % make dvi
  274.  
  275. It's really that easy! (If you have the appropriate tools installed, and
  276. a *real* operating system running on your box...)
  277.  
  278.             -=- * -=-
  279.  
  280.     * WHAT ABOUT A HYPERTEXT INFO FILE?
  281.  
  282.    Well, some moons have passed since edition 1.00, and now it's there!
  283. But you need to patch "makeinfo v1.55" with the included "makeinfo-1.55.
  284. patch" file, and compile it with "-DJOKES=1" defined. Then type "make info"
  285. for the Info, and "make txt" for a TEXT/ASCII version.
  286.  
  287.             -=- * -=-
  288.  
  289.     * HOW TO CREATE THE HTML FILES?
  290.  
  291.    Just say "make html" which runs "texi2html" on "bdgtti.texi" and
  292. creates a bunch of HTML files; Note that "texi2html" needs Larry Wall's
  293. "perl" program to be installed on your system. Maybe you need to edit the
  294. first line in the perl script "#!/usr/local/bin/perl" to whatever
  295. directory "perl" is installed on your system.
  296.  
  297.             -=- * -=-
  298.  
  299.     * HOW TO HANDLE TYPOS, MISTAKES, AND OTHER BUGS?
  300.  
  301.    Given, that this is still the first edition, some "bugs" or other
  302. "quirks" are inevitable, that might have been overseen during Texinfo
  303. production. If you find something, drop me an e-mail; if you have any
  304. comments or questions, want to make further addition or corrections,
  305. please send "all-your-stuff" to the address below. I'll probably include
  306. them into future releases of this guide.
  307.  
  308.    But, please, folks, don't expect an answer on your question until the
  309. weekend following your quest. And thus you might drop me the question
  310. on Fridays. I am currently writing my thesis on something completely
  311. different than the Internet, WWW, Information Retrieval, or something alike,
  312. and thus like to limit the e-mail traffic on this project to the weekends.
  313.  
  314.    Thanx in advance for your patience!
  315.  
  316.             -=- * -=-
  317.  
  318.     * THE CURRENT TEXINFO EDITOR/COORDINATOR?
  319.  
  320.       Joerg Heitkoetter
  321.      <joke@ls11.informatik.uni-dortmund.de>
  322.  
  323.   c/o Systems Analysis Research Group, LSXI
  324.       Department of Computer Science
  325.       University of Dortmund
  326.       D-44221 Dortmund, Germany
  327.  
  328.             -=- * -=-
  329.  
  330.